home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 007 / bdump.arc / BDUMP.DOC next >
Text File  |  1987-07-19  |  4KB  |  104 lines
  1.                   BDUMP - A Btrieve File Dump Utility
  2.                   -----------------------------------
  3.  
  4.                           by Steve Liberty
  5.                         Ver 1.0 -- July 1987
  6.  
  7.  
  8.  
  9.   *** This documentation file has been abreviated for the demo version. ***
  10.  
  11.  
  12. The BDUMP.EXE program is a file dump utility that displays the records of
  13. a Btrieve file in both hex and ASCII in the usual dump format. Each record
  14. is dumped separately with an offset heading, 16 bytes per line. 
  15.  
  16. If BDUMP is entered without any command tail, the help screen will be 
  17. displayed.
  18.  
  19. There are several command line parameters that can be specified to invoke 
  20. BDUMP options. The general command syntax is:
  21.  
  22.       BDUMP filename   /option:parameter   /option
  23.  
  24. Some options have parameters and other do not. Each option is described 
  25. below.
  26.  
  27.       /seq:aa       Select aa as the number of the key to use in sequencing the 
  28.                     records. The defult key is 0.
  29.  
  30.       /start:bb     Start dumping from record number bb according to the
  31.                     selected or default key sequence. The default is record 1.
  32.  
  33.       /end:cc       Stop dumping after record number cc according to the
  34.                     selected or default key sequence. The default is record
  35.                     2147483647. This is also the highest record number that
  36.                     BDUMP can reliably handle.
  37.  
  38.       /key:dddd     Dump only the records whose key matches dddd for the 
  39.                     length of dddd, using the default or selected key 
  40.                     sequence. This option has no default.
  41.  
  42.  
  43.       /fkey:eeee    Start dumping from the first record whose key matches 
  44.                     eeee for the length off eeee, or is greater than it. 
  45.                     The default is all NULL characters.
  46.  
  47.       /lkey:ffff    Stop dumping after the last record whose key matches 
  48.                     ffff for the length off ffff, or is less than it. 
  49.                     The default is all ASCII 122 characters.
  50.  
  51.       /pause        Pause display after each record.
  52.  
  53.       /print        Print the dump instead of displaying it.
  54.  
  55. Each option is totally optional and non-positional. If /start and/or /end
  56. parameters are given, the /key, /fkey, and /lkey parameters will be ignored
  57. if they are also present. If /fkey and/or /lkey parameters are given, the
  58. /key parameter will be ignored if it is also present.
  59.  
  60. Example 1.
  61. ----------
  62.  
  63.            bdump account.dat /start:10 /end:25 /seq:2
  64.  
  65. Use key field 2 to search file account.dat. Dump the 10th through 25th 
  66. records found.
  67.  
  68. Example 2.
  69. ----------
  70.  
  71.            bdump employee.dat /seq:1 /key:Jones
  72.  
  73. Use key field 1 to search file employee.dat. Dump all records with key whose
  74. first five characters are equal to Jones.
  75.  
  76. Example 3.
  77. ----------
  78.  
  79.            bdump staff.dat /start:5 /key:Smith
  80.  
  81. Use default key field 0 to search file staff.dat. Dump all records starting
  82. with record five. Ignore key parameter.
  83.  
  84. Example 4.
  85. ----------
  86.  
  87.            bdump staff.dat /fkey:Jones /lkey:Smith
  88.  
  89. Use default key field 0 to search file staff.dat. Begin dump with records 
  90. whose first five characters are greater than or equal to Jones, and continue
  91. until after dumping the last record whose first five characters are less than 
  92. or equal to Smith.
  93.  
  94.  
  95.  
  96. If you find the program to be of interest to you, you can obtain
  97. the full version by sending a check for $35.00 to:
  98.  
  99.                       Steve Liberty
  100.                       36 Van Pelt Ct.
  101.                       East Brunswick NJ, 08816
  102.  
  103. See the READ.ME file for more information.
  104.